---
title: RunOutput
sidebarTitle: Run Output & Events
---

## RunOutput Attributes

| Attribute          | Type                         | Default                       | Description                                                                                        |
| ------------------ | ---------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------- |
| `run_id`           | `Optional[str]`              | `None`                        | Run ID                                                                                             |
| `agent_id`         | `Optional[str]`              | `None`                        | Agent ID for the run                                                                               |
| `agent_name`       | `Optional[str]`              | `None`                        | Agent name for the run                                                                             |
| `session_id`       | `Optional[str]`              | `None`                        | Session ID for the run                                                                             |
| `parent_run_id`    | `Optional[str]`              | `None`                        | Parent run ID                                                                                      |
| `workflow_id`      | `Optional[str]`              | `None`                        | Workflow ID if this run is part of a workflow                                                      |
| `user_id`          | `Optional[str]`              | `None`                        | User ID associated with the run                                                                    |
| `content`          | `Optional[Any]`              | `None`                        | Content of the response                                                                            |
| `content_type`     | `str`                        | `"str"`                       | Specifies the data type of the content                                                            |
| `reasoning_content`| `Optional[str]`              | `None`                        | Any reasoning content the model produced                                                           |
| `reasoning_steps`  | `Optional[List[ReasoningStep]]` | `None`                        | List of reasoning steps                                                                            |
| `reasoning_messages` | `Optional[List[Message]]`   | `None`                        | List of reasoning messages                                                                         |
| `model`            | `Optional[str]`              | `None`                        | The model used in the run                                                                          |
| `model_provider`   | `Optional[str]`              | `None`                        | The model provider used in the run                                                                |
| `messages`         | `Optional[List[Message]]`    | `None`                        | A list of messages included in the response                                                       |
| `metrics`          | `Optional[Metrics]`          | `None`                        | Usage metrics of the run                                                                          |
| `additional_input` | `Optional[List[Message]]`    | `None`                        | Additional input messages                                                                          |
| `tools`            | `Optional[List[ToolExecution]]` | `None`                        | List of tool executions                                                                           |
| `images`           | `Optional[List[Image]]` | `None`                        | List of images attached to the response                                                           |
| `videos`           | `Optional[List[Video]]` | `None`                        | List of videos attached to the response                                                           |
| `audio`            | `Optional[List[Audio]]` | `None`                        | List of audio snippets attached to the response                                                   |
| `files`            | `Optional[List[File]]` | `None`                        | List of files attached to the response                                                            |
| `response_audio`   | `Optional[Audio]`    | `None`                        | The model's raw response in audio                                                                 |
| `input`            | `Optional[RunInput]`         | `None`                        | Input media and messages from user                                                                |
| `citations`        | `Optional[Citations]`        | `None`                        | Any citations used in the response                                                                |
| `model_provider_data` | `Optional[Any]` | `None` | Model provider specific metadata|
| `references`       | `Optional[List[MessageReferences]]` | `None`                        | References used in the response                                                                    |
| `metadata`         | `Optional[Dict[str, Any]]`   | `None`                        | Metadata associated with the run                                                                  |
| `created_at`       | `int`                        | Current timestamp             | Unix timestamp of the response creation                                                           |
| `events`           | `Optional[List[RunOutputEvent]]` | `None`                        | List of events that occurred during the run                                                       |
| `status`           | `RunStatus`                  | `RunStatus.running`           | Status of the run (running, completed, paused, cancelled, error)                                  |
| `workflow_step_id` | `Optional[str]`              | `None`                        | Workflow step ID (foreign key relationship)                                                       |

## RunOutputEvent Types and Attributes

### Base RunOutputEvent Attributes

All events inherit from `BaseAgentRunEvent` which provides these common attributes:

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `created_at` | `int` | Current timestamp | Unix timestamp of the event creation |
| `event` | `str` | Event type value | The type of event |
| `agent_id` | `str` | `""` | ID of the agent generating the event |
| `agent_name` | `str` | `""` | Name of the agent generating the event |
| `run_id` | `Optional[str]` | `None` | ID of the current run |
| `session_id` | `Optional[str]` | `None` | ID of the current session |
| `workflow_id` | `Optional[str]` | `None` | ID of the workflow if part of workflow execution |
| `workflow_run_id` | `Optional[str]` | `None` | ID of the workflow run |
| `step_id` | `Optional[str]` | `None` | ID of the workflow step |
| `step_name` | `Optional[str]` | `None` | Name of the workflow step |
| `step_index` | `Optional[int]` | `None` | Index of the workflow step |
| `tools` | `Optional[List[ToolExecution]]` | `None` | Tools associated with this event |
| `content` | `Optional[Any]` | `None` | For backwards compatibility |

### RunStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunStarted"` | Event type |
| `model` | `str` | `""` | The model being used |
| `model_provider` | `str` | `""` | The provider of the model |

### RunContentEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunContent"` | Event type |
| `content` | `Optional[Any]` | `None` | The content of the response |
| `content_type` | `str` | `"str"` | Type of the content |
| `reasoning_content` | `Optional[str]` | `None` | Reasoning content produced |
| `citations` | `Optional[Citations]` | `None` | Citations used in the response |
| `model_provider_data` | `Optional[Any]` | `None` | Model provider specific metadata|
| `response_audio` | `Optional[Audio]` | `None` | Model's audio response |
| `image` | `Optional[Image]` | `None` | Image attached to the response |
| `references` | `Optional[List[MessageReferences]]` | `None` | References used in the response |
| `additional_input` | `Optional[List[Message]]` | `None` | Additional input messages |
| `reasoning_steps` | `Optional[List[ReasoningStep]]` | `None` | Reasoning steps |
| `reasoning_messages` | `Optional[List[Message]]` | `None` | Reasoning messages |

### RunContentCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunContentCompleted"` | Event type |

### IntermediateRunContentEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunIntermediateContent"` | Event type |
| `content` | `Optional[Any]` | `None` | Intermediate content of the response |
| `content_type` | `str` | `"str"` | Type of the content |

### RunCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunCompleted"` | Event type |
| `content` | `Optional[Any]` | `None` | Final content of the response |
| `content_type` | `str` | `"str"` | Type of the content |
| `reasoning_content` | `Optional[str]` | `None` | Reasoning content produced |
| `citations` | `Optional[Citations]` | `None` | Citations used in the response |
| `model_provider_data` | `Optional[Any]` | `None` | Model provider specific metadata|
| `images` | `Optional[List[Image]]` | `None` | Images attached to the response |
| `videos` | `Optional[List[Video]]` | `None` | Videos attached to the response |
| `audio` | `Optional[List[Audio]]` | `None` | Audio snippets attached to the response |
| `response_audio` | `Optional[Audio]` | `None` | Model's audio response |
| `references` | `Optional[List[MessageReferences]]` | `None` | References used in the response |
| `additional_input` | `Optional[List[Message]]` | `None` | Additional input messages |
| `reasoning_steps` | `Optional[List[ReasoningStep]]` | `None` | Reasoning steps |
| `reasoning_messages` | `Optional[List[Message]]` | `None` | Reasoning messages |
| `metadata` | `Optional[Dict[str, Any]]` | `None` | Additional metadata |
| `metrics` | `Optional[Metrics]` | `None` | Usage metrics |

### RunPausedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunPaused"` | Event type |
| `tools` | `Optional[List[ToolExecution]]` | `None` | Tools that require confirmation |

### RunContinuedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunContinued"` | Event type |



### RunErrorEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunError"` | Event type |
| `content` | `Optional[str]` | `None` | Error message |

### RunCancelledEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"RunCancelled"` | Event type |
| `reason` | `Optional[str]` | `None` | Reason for cancellation |

### PreHookStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"PreHookStarted"` | Event type |
| `pre_hook_name` | `Optional[str]` | `None` | Name of the pre-hook being executed |
| `run_input` | `Optional[RunInput]` | `None` | The run input passed to the hook |

### PreHookCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"PreHookCompleted"` | Event type |
| `pre_hook_name` | `Optional[str]` | `None` | Name of the pre-hook that completed |
| `run_input` | `Optional[RunInput]` | `None` | The run input passed to the hook |

### PostHookStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"PostHookStarted"` | Event type |
| `post_hook_name` | `Optional[str]` | `None` | Name of the post-hook being executed |

### PostHookCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"PostHookCompleted"` | Event type |
| `post_hook_name` | `Optional[str]` | `None` | Name of the post-hook that completed |

### ReasoningStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"ReasoningStarted"` | Event type |


### ReasoningStepEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"ReasoningStep"` | Event type |
| `content` | `Optional[Any]` | `None` | Content of the reasoning step |
| `content_type` | `str` | `"str"` | Type of the content |
| `reasoning_content` | `str` | `""` | Detailed reasoning content |

### ReasoningCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"ReasoningCompleted"` | Event type |
| `content` | `Optional[Any]` | `None` | Content of the reasoning step |
| `content_type` | `str` | `"str"` | Type of the content |

### ToolCallStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"ToolCallStarted"` | Event type |
| `tool` | `Optional[ToolExecution]` | `None` | The tool being called |

### ToolCallCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"ToolCallCompleted"` | Event type |
| `tool` | `Optional[ToolExecution]` | `None` | The tool that was called |
| `content` | `Optional[Any]` | `None` | Result of the tool call |
| `images` | `Optional[List[Image]]` | `None` | Images produced by the tool |
| `videos` | `Optional[List[Video]]` | `None` | Videos produced by the tool |
| `audio` | `Optional[List[Audio]]` | `None` | Audio produced by the tool |

### MemoryUpdateStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"MemoryUpdateStarted"` | Event type |


### MemoryUpdateCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"MemoryUpdateCompleted"` | Event type |

### SessionSummaryStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"SessionSummaryStarted"` | Event type |

### SessionSummaryCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"SessionSummaryCompleted"` | Event type |
| `session_summary` | `Optional[SessionSummary]` | `None` | The generated session summary |

### ParserModelResponseStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"ParserModelResponseStarted"` | Event type |

### ParserModelResponseCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"ParserModelResponseCompleted"` | Event type |

### OutputModelResponseStartedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"OutputModelResponseStarted"` | Event type |

### OutputModelResponseCompletedEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"OutputModelResponseCompleted"` | Event type |

### CustomEvent

| Attribute | Type | Default | Description |
|-----------|------|---------|-------------|
| `event` | `str` | `"CustomEvent"` | Event type |
